Crate assert_fs

Filesystem fixtures and assertions for testing.

assert_fs aims to simplify

• Setting up files for your tests to consume
• Asserting on files produced by your tests

Overview

Setting up a fixture

• TempDir or NamedTempFile for a sandbox to test in.
• touch a ChildPath or NamedTempFile
• write_binary a ChildPath or NamedTempFile
• write_str a ChildPath or NamedTempFile
• write_file a ChildPath or NamedTempFile
• copy_from a pristine folder to a ChildPath or TempDir
• symlink_to_file a ChildPath or NamedTempFile
• symlink_to_dir a ChildPath or TempDir

Validating

• assert a ChildPath, TempDir, or NamedTempFile

Example

Here is a trivial example:

use assert_fs::prelude::*;
use predicates::prelude::*;

let temp = assert_fs::TempDir::new().unwrap();
let input_file = temp.child("foo.txt");
input_file.touch().unwrap();

// ... do something with input_file ...

input_file.assert("");
temp.child("bar.txt").assert(predicate::path::missing());

temp.close().unwrap();

Modules

• assert
  Filesystem assertions.
• fixture
  Initialize the filesystem to use as test fixtures.
• prelude
  Extension traits that are useful to have available.

Structs

• NamedTempFile
  A potential file in the filesystem that is automatically deleted when it goes out of scope.
• TempDir
  A directory in the filesystem that is automatically deleted when it goes out of scope.